# Apache Web Server

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

The Apache Web Server (Apache HTTP Server) is an open-source, cross-platform web server software developed and maintained by the Apache Software Foundation. Renowned for its stability, security, and high scalability, it supports a wide range of features through its versatile modules. As one of the most widely used web servers globally, it is commonly used in scenarios such as website hosting, dynamic application support, and reverse proxy services.

This document provides instructions on how to install and run the **Apache Web Server** on Debian/Linux.

# Preparation

1. Confirm the device environment.  
    - The device is now able to connect to the network normally.  
    - The Windows host and the device are within the same local area network.

2. Check network connectivity.  
    - Execute `ping www.google.com` on the terminal. If you can see response time information, it indicates that the network is normal.

# Install Apache Web service

Apache is one of the most commonly used web server programs, which is used to provide website access services.

1. Update the software repository:

```plaintext
sudo apt update
```

2. Install the Apache service:

```plaintext
sudo apt install apache2 -y
```

# Start and configure auto-start

1. Start the Apache service:

```plaintext
sudo systemctl start apache2
```

> Start the Web service to make it run immediately.

2. Set Apache to start automatically on boot:

```plaintext
sudo systemctl enable apache2
```

> After this configuration, Apache will automatically start every time the system boots.

3. Check the running status:

```plaintext
sudo systemctl status apache2
```

# Check device IP address

```plaintext
sudo ifconfig
```

# Test whether Apache has been installed successfully

1. Access through the computer browser within the same network:

```plaintext
http://Your device's IP address
```

If everything is normal, you will see the default page of Apache.

```{image} images/image_SFBnbt1NLoSVo3x0mL8cCgkinvg.webp
:width: 827px
:height: 947px
```

# Change default web page

Apache’s default web page is an HTML file located at `/var/www/html/index.html`.

Navigate to the directory and view its contents:

```plaintext
cd /var/www/html
ls -al
```

The following content will be displayed:

```plaintext
total 20
drwxr-xr-x 2 root root  4096 Oct 30 07:53 .
drwxr-xr-x 3 root root  4096 Oct 30 06:51 ..
-rw-r--r-- 1 root root 10703 Oct 30 06:51 index.html
```

By default, the `index.html` file in the `/var/www/html` directory is owned by the `root` user. Since regular users do not have permission to directly modify files owned by `root`, you must change the file ownership to your own username if you wish to edit the webpage:

```plaintext
sudo chown <username>: index.html
```

Now you can edit the file. After making changes, simply refresh your browser to view the updated webpage.

If you are familiar with HTML, you can also place your own HTML files and other resources in this directory and access them as a website via the local network.